<html>
<head>
<!-- Copyright (c) GoAhead Software Inc., 1995-2010. All Rights Reserved. -->
<title>websOpenListen -- GoAhead WebServer API</title>
<link rel="stylesheet" href="../../../style/doc.css" type="text/css">
</head>

<body>
<table class=apitable> <tr><td>
<TABLE border=0 width=100% cellspacing=0 cellpadding=0 CLASS="apiTitle"> <TR> 
<td class="titleLeft" align=left width="33%"><b>websOpenListen</b></TD><td class="titleCenter" align=center width="33%"><b>GoAhead 
WebServer API</b></TD><td class="titleRight" align=right width="33%"><B>GoAhead 
EMF</B></TD></TR> </TABLE><HR> <h2>Synopsis</h2><p>Open the TCP/IP port used by 
the Web server to listen for browser requests.</p><h2>Prototype</h2><pre> #include &quot;webs.h&quot; 

 int <b>websOpenListen</b>(int port, int retries); </pre><h2>Parameters</h2><TABLE WIDTH=100% BORDER=0 CELLPADDING="0" CELLSPACING="0"> 
<TR> <TD VALIGN="TOP" WIDTH="6%">port</TD><TD WIDTH="94%">The port to open for 
GoAhead WebServer to listen on.</TD></TR> <TR> <TD VALIGN="TOP" WIDTH="6%">retries</TD><TD WIDTH="94%">The 
number of times websOpen will try to open the next available port if <I>port</I> 
is not available.</TD></TR> </TABLE><h2>Description</h2><P>The websOpenListen 
procedure opens the TCP/IP port on which the GoAhead WebServer listens for browser 
requests. You should call <A href="websCloseListen.htm">websCloseListen</A> to 
close the existing listen port before calling websOpenListen. Normally websOpenListen 
is called automatically when you call <A href="websOpen.htm">websOpen</A>.</P><P>The 
<EM>port </EM>parameter specifies the TCP/IP to open. If this cannot be opened 
and <EM>retries </EM>is greater than zero, the next port in sequence will be opened 
for up to <EM>retries </EM>times until a port is successfully opened. To determine 
the port number actually opened, call <a href="websGetPort.htm">websGetPort</a>.</P><h2>Return 
Value</h2><p>Returns 0 if the open succeeds; otherwise, -1 is returned.</p><h2>Example</h2><pre> 
websCloseListen(); 
websOpenListen(80, 5); </pre><h2>Stability Classification</h2><p>Stable.</p><h2>See 
Also</h2><p> <A href="websClose.htm">websClose</A>, <A href="websCloseListen.htm">websCloseListen</A> 
</p></td></tr></table>
</body>
</html>
